KCChangeSettings

KCChangeSettings
Header:	Keychain.h		Carbon status:	Under Evaluation

Displays a dialog box enabling the user to change the name, password, or settings of a keychain.

OSStatus KCChangeSettings (
    KCRef keychain
);

Parameter descriptions

keychain: A reference to an unlocked keychain. Pass in NULL to specify the default keychain.

function result: A result code. The result code errUserCanceled indicates that the user pressed the Cancel button in the Change Settings dialog box. The result code errKCNoDefaultKeychain indicates that the default keychain could not be found. The result code errKCInvalidKeychain indicates that the specified keychain is invalid.

DISCUSSION

Typically, your application should not call the KCChangeSettings function. You would only call KCChangeSettings in response to a user's request to change keychain settings, name, or password. Note that you cannot change a keychain passphrase directly. You must call KCChangeSettings and allow the user to change it.

VERSION NOTES

Available beginning with Keychain Manager 1.0.